home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / SEE.ZIP / SEE.DOC next >
Text File  |  1987-10-09  |  10KB  |  190 lines
  1.  
  2.  
  3.           SEE Version 1.7                                   October 9, 1987
  4.  
  5.                                    COPYRIGHT 1987
  6.                                          by
  7.                                ABACUS Computer Service
  8.                                  Donald J. Jackowski
  9.                                     16 Green Road
  10.                                 Mine Hill, NJ  07801
  11.                                    (201) 584-8201
  12.                                  All Rights Reserved
  13.  
  14.           INTRODUCTION
  15.                SEE is  a utility  program that  allows a  user to display a
  16.           file containing  non-printable  characters  and  to  make limited
  17.           modifications  to  the  input  to  create  a  file that most text
  18.           editors can handle.  An  option  is  provided  to  strip (Ignore)
  19.           printer control  sequences, making it easy to create a pure ASCII
  20.           file from one containing printer control characters.
  21.  
  22.                Non-printable characters are divided into two classes, those
  23.           in  the  numeric  range  0  through  31  are  considered  CONTROL
  24.           characters except for the four characters that normally  occur in
  25.           text files  namely the  "newline" character (10, ^J, \n, NL), the
  26.           "return" character (13, ^M, \r, CR), the "tab"  character (9, ^I,
  27.           \t,  TAB)  and  the  "formfeed"  character (12, ^L, \f, FF).  The
  28.           second class called GRAPHIC  characters is  comprised of  all the
  29.           characters  in  the  numeric  range  127  through 255.  Some text
  30.           editing programs will not operate correctly on a  file containing
  31.           either class  of non-printable  characters and many programs take
  32.           the control character 26 (^Z) to be an End Of  File marker.   SEE
  33.           offers  a  mechanism  to  allow  the user to visually observe the
  34.           characters contained in  ANY  file  and  then  make  some limited
  35.           substitutions that  will render the output acceptable to any text
  36.           editor.
  37.  
  38.           USAGE
  39.                The SEE program usage is:
  40.                     SEE [-aipstNwNiho] file ...
  41.                Where:
  42.                     -a  = show ALL characters.
  43.                     -i  = Ignore ALL non-printing characters.
  44.                     -p  = Ignore ALL Printer control sequences.
  45.                     -s  = Substitute a 'space' for each control character.
  46.                     -ss = Substitute a 'space' for each non-printing char.
  47.                     -tN = Set Tab Stop value. (default 8)
  48.                     -wN = Set output column Width. (default 78)
  49.                     -h  = Show Hex values.
  50.                     -o  = Show Octal values.
  51.  
  52.                When SEE is invoked with no arguments or  if invalid options
  53.           are given,  a short  menu is displayed.  When SEE is invoked with
  54.           one or more file names but no options  the contents  of each file
  55.           is displayed,  all normally non-printing characters are displayed
  56.           as a series of regular printing  characters.   CONTROL characters
  57.           are  displayed  in  the  ^A  style  and  GRAPHIC  characters  are
  58.           displayed as a three digit number surrounded by  the <> character
  59.           pair.
  60.  
  61.  
  62.  
  63.  
  64.           Copyright 1987 (C) by ABACUS Computer Service         Page 1 of 3
  65.  
  66.           SEE Version 1.7                                   October 9, 1987
  67.  
  68.           OPERATION
  69.                The  control  characters  "new  line",  "return", "tab", and
  70.           "form feed" are displayed  as  normal  characters  unless  the -a
  71.           option is  given in  which case they are displayed as ^J, ^M, ^I,
  72.           and ^L.  When the -a option is  given the  length of  each output
  73.           line is  a result of the default column Width setting unless this
  74.           default is changed with the -w option. 
  75.  
  76.                The -s option can be  used  to  cause  SEE  to  substitute a
  77.           'space'  character  (decimal  32)  for  each  occurrence of a any
  78.           control character, if used in conjunction with the  -a option the
  79.           substitution includes  the "new line", "return", "tab", and "form
  80.           feed" characters.  If the -ss option is given a 'space' character
  81.           is  substituted  for  each  GRAPHIC  character"  as  well as each
  82.           CONTROL character."
  83.  
  84.                The  -i  option  will   ignore  both   CONTROL  and  GRAPHIC
  85.           characters and will override and disable the -s option.
  86.  
  87.                The  -p  option  will  ignore  printer control sequences and
  88.           automatically turns on the -i option.  This  option uses  a table
  89.           to determine  the number of bytes to ignore after an ESC (decimal
  90.           27) character.  The default table  contains the  data appropriate
  91.           for an  EPSON FX-85  printer but can be easily modified for other
  92.           printers as outlined under OTHER PRINTERS.
  93.  
  94.                The SEE output (normally displayed  on  the  screen)  can be
  95.           redirected to a file.  For example the command line:
  96.                     SEE file >temp
  97.           Will place the output in the file named TEMP.
  98.  
  99.                Since  SEE  does  not  actually  display  on  the screen but
  100.           depends on the DOS to do  the actual  display the  -t option will
  101.           NOT  affect  the  actual  display.   The -t option is intended to
  102.           provide  tab  setting  control  when  SEE   calculates  how  many
  103.           characters to  permit on  a line, and is generally only needed in
  104.           conjunction with the -w option.  SEE expects  both the  -t and -w
  105.           options to  be given with a number, the first digit of the number
  106.           may be given  immediately  after  the  option  letter  or  may be
  107.           separated from  the option  letter by a 'space', thus the command
  108.           lines:
  109.                     SEE -w45 file       and
  110.                     SEE -w 45 file
  111.           Are equivalent, both set the column width to 45.
  112.  
  113.           NOTE
  114.                An interesting use of SEE is to look for message  strings in
  115.           normally unprintable  executable files (i.e .EXE and .COM files).
  116.           For example the command line:
  117.                     SEE -i SEE.EXE
  118.           Will display some random characters, some  of the  actual machine
  119.           codes, and all of the internal messages.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.           Copyright 1987 (C) by ABACUS Computer Service         Page 2 of 3
  128.  
  129.           SEE Version 1.7                                   October 9, 1987
  130.  
  131.           USER LICENSE
  132.                If you  find this program useful you are requested to send a
  133.           $10 registration and  license  fee  to  ABACUS  Computer Service.
  134.           This  fee  will  entitle  you  to  continue that use with a clear
  135.           conscience.  Please pass a copy to a friend!  It is NOT necessary
  136.           to be a licensed user to distribute copies.  All registered users
  137.           will receive notice of the first update that is made  after their
  138.           registration. 
  139.  
  140.           OTHER PRINTERS
  141.                The following information is intended as an aid to those who
  142.           use a printer  requiring  different  control  sequences  than the
  143.           EPSON  FX-85.    All  the  ESCAPE  sequence  byte length data are
  144.           maintained in a single  table to  make modification  easier, this
  145.           internal table,  used by  the -p  option, contains  the number of
  146.           bytes to be taken as part of an ESCAPE (27) sequence is:
  147.                /*          0    1    2    3    4    5    6    7    8    9*/
  148.                /* -------------------------------------------------------*/
  149.                /*  00 */   0,   0,   0,   0,   0,   0,   0,   0,   0,   0,
  150.                /*  10 */   0,   0,   0,   0,   1,   1,   0,   0,   0,   0,
  151.                /*  20 */   0,   0,   0,   0,   0,   2,   0,   0,   0,   0,
  152.                /*  30 */   0,   0,   2,   2,   0,   1,   3,   2,   0,   0,
  153.                /*  40 */   0,   0,   0,   0,   0,   2,   0,   2,   1,   1,
  154.                /*  50 */   1,   2,   1,   1,   1,   1,   1,   1,   0,   0,
  155.                /*  60 */   1,   1,   1,   0,   1,   2,   9,   2,   9,   1,
  156.                /*  70 */   1,   1,   1,   2,   2,   0,   0,   1,   2,   1,
  157.                /*  80 */   1,   2,   2,   2,   1,   2,   0,   2,   0,   0,
  158.                /*  90 */   0,   0,   3,   0,   0,   0,   0,   2,   9,   0,
  159.                /* 100 */   0,   0,   0,   0,   0,   2,   2,   0,   2,   0,
  160.                /* 110 */   0,   0,   2,   0,   0,   2,   0,   0,   0,   0,
  161.                /* 120 */   2,   0,   0,   0,   0,   0,   0,   0
  162.  
  163.                This table contains an entry for  each of  the 128 character
  164.           values that  could be  the byte  immediately following the ESCAPE
  165.           byte.  This table begins at 2A42H in the SEE.EXE file.   The zero
  166.           values in  this table represent "Unexpected ESCAPE sequences", an
  167.           error message is displayed if any  such ESCAPE  sequence is found
  168.           in the input.  The values 1 through 8 represent the length of the
  169.           ESCAPE sequence, excluding the ESC character.   EXAMPLE:  row 50,
  170.           column 1  represents 51  which is  the decimal value of the ASCII
  171.           character '3' and the printer ESCAPE sequence:
  172.                     27   51   (n)
  173.                The  length  of  this  ESCAPE  sequence,  excluding  the ESC
  174.           character is two.
  175.  
  176.                The value  9 is interpreted to mean that the next NULL input
  177.           byte marks the end of the  ESCAPE  sequence.    EXAMPLE:  row 60,
  178.           column 8  represents 68  which is  the decimal value of the ASCII
  179.           character 'D' and the printer ESCAPE sequence:
  180.                     27   68   (n1) (n2) ...  0 (NULL)
  181.                The length of this sequence is  signaled by  the terminating
  182.           NULL (zero) byte.
  183.  
  184.                If you alter this table to accommodate a different printer I
  185.           would appreciate if you  would send  a copy  of your  table along
  186.           with the  printer make  and model  to: ABACUS  Computer Service. 
  187.           Future versions of SEE will include the data we receive  on other
  188.           printers, and/or an "install" program.
  189.  
  190.           Copyright 1987 (C) by ABACUS Computer Service         Page 3 of 3